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ABSTRACT 


This  Operational  Concept  Document  (OCD)  describee  the  mission  of  the  Mapping 
and  Graphic  Information  Capability  (MAGIC)  and  its  operational  and  support 
environments.  It  also  describes  the  functions  and  characteristics  of  MAGIC 
within  the  overall  computer  system. 

The  OCD  is  divided  into  three  major  sections.  These  sections  cover  Mission 
(Section  3),  System  Functions  and  Characteristics  (Section  4),  and  Government 
Agencies  (Section  3). 

This  document  aupersedes  the  Operational  Concept  Document  for  the  Graphic 
Information  Presentation  System  (GIPSY)  that  was  dated  30  September  1988. 
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SECTION  1.  SCOPE 


This  section  provides  an  introduction  to  the  document.  The  following 
paragraphs  define  the  soope  of  the  document  by  providing  the  identification 
and  purpose  of  the  Happing  and  Craphic  Information  Capability  (MAGIC)  and 
presenting  an  Introduction  to  the  rest  of  the  document. 

1.1  Identification 

This  Operational  Concept  Document  (OCD)  describes  the  mission  of  MAGIC  and  Its 
operational  and  support  environments.  It  also  describes  the  functions  end 
characteristics  of  the  computer  system  within  the  overall  system. 

1.2  Purpose 

The  MAGIC  effort  has  evolved  from  and  will  build  upon  the  modernisation  of  the 
WWMCCS  standard  host 'based  Graphic  Information  Presentation  System  (GIPSY)  end 
the  Z-248  PC-based  modernised  GIPSYmate  system. 

Designed  end  developed  to  meet  the  needs  of  a  new  generation  of  Worldwide 
Military  Command  and  Control  System  (WUMCCS)  users,  MAGIC  will  be  fielded  as  a 
resident  system  on  the  WWMCCS  Workstation  (WWS)  and  will  present  e  menu-baaed 
graphical  user  interface  (GUI)  to  the  user  that  integrates  (as  transparently 
as  feasible)  the  Commercial  Off -the-Shslf  (COTS)  packages  also  resident  on 
that  platform.  Processing  facilities  appropriate  to  both  sophisticated  and 
novice  users  will  be  supported  as  well  as  the  ability  to  aocess  the  full  range 
of  database  types  found  on  the  WWMCCS  host  (H6000) . 

Functionally,  the  MAGIC  user  will  have  the  capability  to  perform  date 
retrieval  and  manipulation  operations,  business  graphics  displays,  geographic 
and  geodetic  mapping  displays,  slide  show  generation,  and  graphic  editing 
operationa. 

1.3  IntI9dWfi.LL.8n 

This  QCD  describes  MAGIC'S  mission  as  well  as  its  operational  and  support 
environments .  It  also  describee  the  functions  and  characteristics  of  MACIC 
within  the  overall  WWMCCS  environment.  As  such,  this  do.  ament  represents  the 
complete  operational  concept  to  be  used  in  MAGIC'S  development  under  the 
DOD-STD-2167A  life  cycle, 
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SECTION  2.  REFERENCED  DOCUMENTS 


This  section  contains  a  listing  of  all  documents  used  in  the  preparation  of 
this  document.  A  detailed  bibliography  appears  as  paragraph  6.1.  Technical 
society  and  technical  association  specifications  and  standards  are  generally 
available  for  reference  from  libraries.  They  are  also  distributed  among 
technical  groups  and  using  Federal  Agencies. 

SPECIFICATIONS : 

CSM  UM  259-85  Graphic  Information  Presentation  System  (GIPSY)  Users 

Manual 

CSM  UM  305-87  GIPSYmate  Users  Manual 

DI-MCCR- 80023  Operational  Concept  Document  Data  Item  Description 

(DID) 

SDP  2-90  Software  Development  Plan  (SDP)  for  Mapping  and 

Graphic  Information  Capability  System  (MAGIC) 

SPM  SS  161-88  System  Design  Document  for  the  Modernised  GIPSYmate 

System 

<reference>  Functional  Description  for  the  Graphic  Information 

Presentation  System  (GIPSY) 

<referenoe>  Software  Quality  Program  Plan  for  Mapping  and  Graphic 

Information  Capability  System  (MAGIC)  (Draft) 

STANDARDS : 

DOD-STD-2167A  Defense  System  Software  Development 
DRAWINGS : 

None 

OTHER  PUBLICATIONS: 

PM  1-90  Documentation  Standards  and  Publications  Style  Manual 

TM  405-90  Software  Standards  and  Procedures  Manual  for  the  JNGG 

Graphics  Program 

Copies  of  the  specifications,  standards,  drawings,  and  publications  required 
by  suppliers  in  connection  with  specified  procurement  functions  should  be 
obtained  from  the  contracting  agency  or  as  directed  by  the  contracting 
officer. 
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SECTION  3.  MISSION 


The  following  paragraphs  define  and  describe  the  mission  to  be  fulfilled  by 
MAGIC  in  the  WWMCCS  environment. 

3.1  Mission  Need  Requirements 

MAGIC  is  an  outgrowth  of  two  older  systems* -GIPSY  and  GIPSYmate.  As  such, 
MAGIC  evolved  to  satisfy  the  graphic  needs  of  the  NMCS.  Capability 
requirements  were  extracted  from  the  documents  Identified  below: 

a.  Functional  Description  for  the  Graphic  Information  Presentation 
System  (GIPSY) 

b.  GIPSYmate  Users  Manual 

c.  Graphic  Information  Presentation  System  (GIPSY)  Users  Manual 

d.  System  Design  Document  for  the  Modernized  GIPSYmate  System. 

3.2  Primary  Mlaslon(s) 

MAGIC  has  two  primary  missions  which  can  be  further  subdivided  for  better 
understanding: 

a.  To  provide  a  basic,  user-oriented,  graphics  capability  (in  both 
graphic  and  alphanumeric  forms)  to  the  WWMCCS  community: 

(1)  Primarily  oriented  toward  the  decision-maker  who  knows  the  data 
but  not  the  intricacies  of  data  processing 

(2)  May  be  interfaced  with  an  application  to  provide  graphic  support 
or  as  an  independent  stand-alone  graphic  Information  system. 

b.  To  provide  the  necessary  technical  assistance  (in  the  form  of  a 
comprehensive  graphics  and  information  display  capability)  to  the 
Joint  Data  Systems  Support  Center  (JDSSC)  in  support  of  the  Joint 
Chiefs  of  Staff  (JCS): 

(1)  Director  for  Operations  (J-3) 

v2)  Director  for  Manpower  and  Personnel  (J-l) 

(3)  Secretary,  Joint  Chiefs  of  Staff  (SJCS) 

(4)  Joint  Special  Operations  Agency  (JSOA) 

(5)  Office  of  the  Secretary  of  Defense/Director,  Program  Analysis 
and  Evaluation  (OSD/PA&E) 
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(6)  Assistant  Secretary  of  Defense  for  International  Security  Policy 
(ASD/ISP) 

(7)  Director  for  Commend,  Control,  and  Communications  Systems  (J-6) 

(8)  Director  for  Information  Resource  Management  (DIRM) 

(9)  The  Department  of  Defense  (DOD)  at  large. 

3.3  Sifiandtry.. Milan 

A  secondary  mission  la  to  provide  enhanced  comprehensive  graphics  capabilities 
based  upon  requirements  defined  and  refined  by  the  user  community  after 
exposure  to  the  produot.  This  means  that  MAQIC  will  adapt  and  improve  as  user 
feedback  is  provided.  Enhancement  of  current  functionality,  the  addition  of 
completely  new  capabilities,  and  support  for  new  hardware  oonfiguratlons  are 
the  methods  whereby  this  mission  is  supported. 

3.4  QBimUntl ..EnvUfljaaLtnt 

MAGIC'S  deployed  environment  will  be  the  Unix ‘based  WWMCCS  Workstation  (WUS). 
The  UWS  may  optionally  be  connected  to  the  WWMCCS  host  platform 
(H6000/DPS8000)  to  permit  remote  aocess  to  the  user's  data  on  the  mainframe, 
but  such  a  configuration  is  not  mandatory,  MAGIC  will  operate  in  stand* alone 
mode  on  the  Unix  workstation  as  its  default  mode. 

The  workstation  would  require  the  following  minimum  configuration: 

a.  Hardware  configuration: 

(1)  WWMCCS  Workstation 

(2)  Color  monitor 

(3)  8  Megabytes  (Mb)  of  Random  Access  Memory  (RAM) 

(4)  2  Mb  of  free  disk  space 

(5)  16  Mb  of  swap  space 

(6)  Tape  Backup  Unit  (tar  format) 

(7)  PostScript  printer  (optional). 

b,  Software  configuration: 

(1)  Unix  operating  system 

(2)  X  Windows,  Version  11,  Release  3 
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(3)  OSF/Motif,  Version  1.0. A 


(4)  Oracle  Relational  Databaie  Management  System  (RDBMS) 

(5)  tflngz,  Release  1.0 

(6)  DeLorme  Mapping  System  (DMS)  for  Unix 

(7)  Microsoft  PowerPoint,  Release  2.01, 

3.s  Support . Enyir.ttPflLflnt 

The  following  subparagraphs  briefly  describe  the  support  environment  for 
MAGIC. 

3.5.1  Development  Support  Environment.  The  prototype  system  will  be 
developed  on  the  Sun  Scalable  Processor  Architecture  (SPARC)atutlon.  The 
environment  will  be  comprised  of  the  following  hardware: 

a.  Sun  SPARCscation 

b.  Sun  cg3/6  color  monitor 

c.  8  megabytes  (Mb)  of  Random  Access  Memory  (RAM) 

d.  2  Mb  of  free  disk  space 

e.  16  Mb  of  swap  apace 

f.  Sun  Desktop  Backup  Pack  (DC6150  media). 

The  software  composition  of  the  support  environment  will  be: 

a.  SunOS,  Version  h .0. 3c 

b.  X  Windows,  Version  11,  Release  3  (X11R3) 

c.  OSF/Motif,  Release  1.0. A 

d.  Oracle  RDBMS,  Version  6.0.27 

e.  Oracle  SQL*Plus ,  Version  3. 0.6. 5.1 

f.  Oracle  SQL*Loader,  Version  1.0.18 

g.  Wingz,  Release  1.0 

h.  OpenWindows,  Release  1.0 

i.  Sun  Microsystems  C  compiler  and  linker 


J.  DeL^rme  Mapping  System  (DMS)  for  Unix 

k.  Microsoft  PowerPoint,  Release  2.01. 

3.5.2  Fielded  Support  Environment.  The  production  system  will  be  fielded  on 
the  WWMCCS  Workstation  (assumed  to  be  the  Macintosh  Ilfx) .  The  environment 
will  be  comprised  of  the  following  hardware: 


a. 

WWMCCS  Workstation 

(WWS) 

b. 

Color  monitor 

c . 

8  Mb  of  RAM 

d. 

2  Mb  of  free  disk  space 

e. 

16  Mb  of  swap  space 

f. 

PostScript  printer 

(optional) . 

The  software  composition  of  the  support  environment  will  be: 

a.  Apple/Unix  (A/UX) ,  Version  2.0  with  SecureWare 

b.  X  Windows,  Version  11,  Release  3  (X11R3)  server 

c.  Motif  window  manager  with  SecureWare 

d.  Oracle  RDBMS 
a .  Wings 

f.  DeLorme  Mapping  System  (DMS)  for  Unlx/X  Windows 

g.  Microsoft  PowerPoint,  Release  2.01. 
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SECTION  4.  SYSTEM  FUNCTIONS  AND  CHARACTERISTICS 

This  section  will  define  and  describe  MAGIC'S  system  functions  and 
characteristics  in  the  paragraphs  which  follow. 

4.1  gytflm  Functions 

MAGIC  is  comprised  of  eight  Computer  Software  Configuration  Items  (CSCIs) : 
Human  Interface,  Data  Management,  Business  Graphics,  Geographic  Mapping, 
Graphic  Editor,  Slide  Show,  Internal  Processing,  and  Programmer  Utilities. 

The  functions  that  each  of  these  CSCIs  will  perform  appear  in  the  following 
subparagraphs . 

4.1.1  Human  Interface.  The  Human  Interface  CSCI  functions  as  the  logical  hub 
of  all  MAGIC  processing  activities  and  presents  a  user-friendly  graphical  user 
interface  (GUI)  to  the  user  that  ia  compliant  with  Open  Software  Foundation 
(OSF)/Motlf.  The  user  may  chooae  menu  selections  with  either  keystrokes  or 
mouse  clicks  and  dialog  boxes  are  provided  for  those  instances  whan  the  user 
is  required  to  provide  additional  information  before  MAGIC  can  continue 
processing. 

When  a  user  initiates  a  MAGIC  session,  the  program  menus  are  presented  to  the 
user,  and  control  of  program  actions  begins  in  this  CSCI.  As  users  navigate 
through  the  menu  system  to  an  activity  they  want  to  perform,  control  is 
eventually  passed  to  the  appropriate  functional  CSCI  (or  Commercial  Off-The 
Shelf  (COTS)  package),  such  as  Data  Management  or  Business  Graphics,  to 
perform  the  desired  activity.  The  Human  Interface  CSCI  also  provides  context- 
sensitive  help  that  is  compliant  with  Motif  applications. 

The  following  functions  must  be  performed  by  the  Human  Interface  CSCI: 

a.  Initialise  MAGIC 

b.  Parse  user  selections,  choices,  and  language  input 

c.  Recognize  interactive  operating  system  commands  (i.e,,  JDAC  &  TSS 
commands) 

d.  Define  and  name  a  group  of  GIPSY  statements  which  may  be  subsequently 
executed  through  reference  to  the  defined  name  via  an  application 
(i.e. ,  DO  PROCESS) 

e.  Execute  a  GIPSY  application  which  prompts  the  user  for  input 

f.  Perform  interactive  error  detection  and  handling 

g.  Provide  an  on-line  interactive  help  facility 

h.  Allocate  and  initialize  the  Directive  Action  File  Control  (DAFC)  file 
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1.  Establish  workstation  environment  to  X  Windows 

j.  Access  statistics  file 

k.  Use  OSF/Motif  to  provide  the  graphical  user  Interface. 

4.1.2  Data  Management.  The  Data  Management  CSCI  enables  the  user  to  acceaa 
data  from  user  databases  located  on  either  the  WUMCCS  host  or  the  WWMCCS 
Workstation  (WWS).  The  WUS  databaaaa  may  be  Oracle  relational  database  tables 
to  which  the  user  has  acceaa  or  flat  American  Standard  Code  for  Information 
Interchange  (ASCII)  files.  Data  in  the  databases  is  aelectod  by  a  uaer 
according  to  a  qualification  critarlon;  the  resulting  data  subset  can  then  be 
manipulated  and  presented  as  uaer •formatted  reports,  statistical  graphs,  and 
gaographio  displays. 

The  following  functions  must  be  performed  by  the  Data  Management  CSCI: 

a.  Identify  the  user's  data  file 

b.  Describe  data  records 

(1)  File  Descriptor  Table  (FDT) 

(2)  Adding  to  the  Index  File 

(3)  Augmenting  an  existing  File 


(») 

Extended  fields 

(b) 

Global  fields 

(c) 

Qualify  fields 

(d) 

Specific  field  references 

c. 

Identify 

any  conditional  expressions 

d. 

Identify 

any  arithmetic  expressions 

e. 

Retrieve 

data 

f. 

Modify  data 

(1)  In-line  modification 

(2)  User  subroutine  modification 

(3)  Record  output  table 

(4)  Field  table 
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g.  Manipulate  data 

(1)  Modify  Qualified  Data  Table  (QDT) 

(2)  Add  new  field* 

<3;  Sort  Qualified  Data  File  (QDF)  (alao  re-«ort) 

(4)  Qualify  data 

(5)  Field  table  QDF 

(6)  Field  table  qualify 

(7)  Field  table  call 

h.  Populate  a  database  or  a  data  file. 

4.1.3  Business  Graphic*.  The  Business  Graphics  CSCI  enables  the  MAGIC  user 
to  create  and  display  reports.  Each  report  consists  of  data  selected  from  a 
previously  identified  MAGIC  internal  format  subset  of  a  database.  This  CSCI 
gives  the  user  the  flexibility  to  display  a  report  in  a  form  most  suited  to 
the  user's  needs,  varying  from  simple  formatted  reports  to  line  graphs  and  pie 
charts.  The  Wings  COTS  package  has  been  used  to  provide  the  user  with  two 
levels  of  support:  an  assisted  mode,  whioh  helps  the  user  in  constructing 
reports  and  graphs,  and  an  unassistad  mode  in  which  the  user  is  simply  placed 
into  raw  Wings. 

The  following  functions  must  be  performed  by  the  Business  Graphics  CSCI: 

a.  Build  a  tabular  report 

b.  Display  a  tabular  report 

c.  Modify  a  tabular  report 

d.  Enhance  a  tabular  report 

e .  Save  a  tabular  report 

f.  Acoess  a  previously  saved  tabular  report 

g.  Build  a  new  report 

(1)  Assign  function 

(2)  Delete  function 

(3)  Rename  function 
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(4)  Subset  function 

(5)  Change  function 

(6)  Define  function 

(7)  Add  function 

(8)  Input  function 

(9)  Review  function 

h.  Create  and  display  graphic  reports 

(1)  Bar  graphs 

(2)  Histograms 

(3)  Point  graphs 

(4)  Lins  graphs 

(5)  Curve  graphs 

(6)  Seep  graphs 

(7)  Gantt  charts 

(8)  Pie  oharts 

i.  Modify  a  graphic  report 

(1)  Limiting  rows,  columns,  section,  categories 

(2)  Adding  report  totals 

(3)  Vector  sequencing 

J ,  Display  the  classification  of  graphic  report 

(1)  Report  titles 

(2)  Clear  class 

k.  Explode  the  wedges  in  a  pie  chart 

l.  Stack  the  bars  in  a  bar  graph 

m.  Enhance  graphic  reports  with  symbols  and  text 
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n.  Control  graph  features  Including  size,  color,  shading,  and  style  of 
line 

o.  Save  a  graphic  report 

p.  Save  plotted  output. 

4.1.4  Geographic  Mapping.  The  Geographic  Mapping  CSCI  will  provide  an 
integrated  mapping  capability  that  utilizes  a  DeLorme  Mapping  System  (DMS) 
with  the  following  capabilities: 

a.  All  digital  mapping  system  with  data  resolution  to  1  centimeter 

b.  Capable  of  displaying  veotor  data,  scanned  paper  map  data,  aoanned 
aerial  photography  data,  digital  satellite  imagery,  either  separately 
or  merged 

c.  Capable  of  accessing  and  displaying  digital  geographic  data  at  any 
location  and  level  of  detail  in  an  average  of  6  seconds  or  less  from 
a  database  of  many  gigabytes 

d.  Capable  of  linking  with  an  external  relational  databaae 

e.  Global  vector  databaae  at  1:3,000,000  level  of  detail,  with  select 
areas  at  higher  detail 

f.  Capable  of  centering  the  screen  at  any  looatlon  on  the  Earth's 
surface 

g.  Full  declutter  capabilities  for  vector  data 

h.  Display  data  in  22  levels ,  from  a  world  view  to  a  view  that  shows  an 

area  40  feet  aoross 

I,  Overlay  capabilities  with  text,  lines,  fills,  circles,  boxes,  and 
military,  cartographic,  and  user-defined  symbols 

J .  Overlays  are  geographically  referenced  for  proper  placement  under  pen 
and  zoom  operations 

k.  Special  utilities  such  as  Great  Circle  route  computation,  lat/lon  and 
UTM  grids,  projections,  etc. 

The  following  functions  must  be  performed  by  the  Geographic  Mapping  CSCI: 
a.  Define  the  map 

(1)  Map  file 

(2)  Map  file  details 
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(3)  Map  area 

(4)  Map  projection 

b.  Build  geographic  display 

(1)  Orida 

(2)  Symbol* 

(3)  User-defined  character* 

(4)  Track  plot 

c.  Generate  geographic  display 

d.  View  geographic  display 

e.  Modify  geographio  display 

f.  Save  geographic  display. 

4.1.3  Graphic  Editor.  The  Graphic  Editor  CSC1  provides  an  interactive 
capability  to  enhance  existing  slides,  create  new  slides,  and  edit  multiple 
slides  simultaneously. 

The  following  functions  must  be  performed  by  the  Qraphlc  Editor  CSCI: 
a .  Compose  drawings 

(1)  Standard  draw  functions 


(•) 

Freehand  drawing 

(b) 

Create 

a  line 

(c) 

Create 

a  rectangle 

<d) 

Create 

a  circle 

(•) 

Create 

a  polygon 

Cf) 

Create 

an  arc 

<«> 

Create 

an  ellipse 

(h) 

Fill. 

(2)  Rubberband  technique  draw  functions 
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(a)  Create  a  symbol 

(b)  Zoom 

(c)  Untoom 

(d)  Pan 
(a)  Unpan 
(f)  Erase 

(|)  Change  attributes  (e.g.,  background  color,  foreground 
color,  line  width,  line  style,  fill  pattern,  fill  color). 

b .  Manage  text 

(1)  Enter  horisontal  text 

(2)  Enter  vertical  text 

(3)  Enter  centered  text 

(4)  Set  tab 
(3)  Clear  tab 

(6)  Rotate  text 

(7)  Cut  text 
(B)  Uncut  text 

(9)  Copy  text 

(10)  Paste  text 

(11)  Erase  text 

(12)  Un*eraee  text 

(13)  Set  margins 

(14)  Overwrite  text 

(15)  Change  current  text  attributes  (e.g.,  text  else,  text  style, 
text  spacing,  text  color,  background  color). 

c.  Manipulate  an  object 

J 

i 
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(1)  Cut  art  object/symbol 

(2)  Uncut  an  object/symbol 

(3)  Copy  an  objact/aymbol 

(4)  Paata 

(5)  Group  an  objaet  into  a  symbol 
(€)  Split  an  objaot  from  a  symbol 

(7)  Brass  an  obj«c C/symbol 

(8)  Un* erase  an  objaot/symbol 

(9)  Seals  an  objsct/symbol 

(10)  Rocats  an  objaot/aymbol 

(11)  Modify  objaet  attributes  (e.g.,  objaet  color,  11ns  width,  11ns 
style,  fill  pattern,  fill  color). 

d.  Save  a  slide  to  the  slide  Inventory 

e.  Load  a  new  slide 

f.  Activate  a  loaded  slide 

g.  Overlay  a  loaded  elide 

h.  Print  funotlons 

(1)  Add  a  slide  to  an  output  device  queue 

(2)  List  an  output  device  qvieue 

(3)  Delete  a  slide  from  an  output  devloe  queue 

(4)  Reorder  an  output  devloe  queue 
(3)  Cancel  current  print  Job. 

i.  Clear  the  elide. 


4.1.6  Slide  Show.  The  Slide  Show  CSCI  provides  access  to  two  types  of 
management  capabilities.  First,  it  allows  the  user  to  maintain  an  inventory 
of  slides;  and  second,  it  provides  the  user  the  ability  to  organise  slides 
into  a  briefing. 
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The  following  functions  must  be  performed  by  the  Slide  Show  CSCI : 

a.  Modifying  the  slide/briefing  inventory 

(1)  Rename  elides 

(2)  Rename  briefings 

(3)  Create  briefings 

(4)  Delete  briefings 

(5)  Include  a  slide  from  the  slide  Inventory  to  a  briefing 

(6)  Delete  a  slide  from  a  briefing 

(7)  Delete  a  slide  from  the  slide  inventory  (and  from  any  briefings 
that  may  contain  it) 

(8)  Save  a  slide  to  the  slide  inventory. 

b.  Displaying  slides 

(1)  Display  any  individual  slide  from  the  Inventory  of  slides 

(2)  Display  any  individual  slide  from  a  briefing 

(3)  Display  the  next  slide 

(4)  Display  the  previous  slide 

(3)  Automatically  display  all  slides  in  a  briefing 

(6)  Overlay  any  individual  slide  over  the  currently  displayed  slide. 

c.  Importing  or  exporting  slides 

(1)  Copy  slide 

(2)  Copy  briefing 

(3)  Create  backup  copy 

(4)  Tranafer  slide  to  another  inventory 

(5)  Transfer  briefing  to  another  inventory. 

d.  Printing  slides 

(1)  Add  slide  to  queue 


(2)  Liat  queue 

(3)  Delete  from  queue 

(4)  Reorder  queue 

(5)  Cancel  current  print  job. 

4.1.7  Internal  Pfocoealr^.  The  Internal  Processing  CSCI  provides 
capabilities  chat  are  hardware- dependant  or  required  by  more  than  one  CSCI. 
This  CSCI  provides  a  multitude  of  services  unseen  by  the  user  but  critical  to 
MAGIC  functionality.  Aw  Its  name  implies,  a  variety  of  low-level  services 
that  tie  the  various  functional  CSCZa  together  are  provided.  They  are  as 
follows: 


a.  MAGIC  environment  initialisation  and  cleanup 

b.  File  Input/output  (I/O)  functions  such  as  open,  close,  read,  and 
write  operations 

c.  Functions  useful  to  a  number  of  MAGIC’S  CSCIs,  such  as  string 
utilities  and  pathname  processing 

d.  Communications  between  the  Unix  workstation  and  the  WWMCCS  host 
platform. 

The  following  functions  must  be  performed  by  the  Internal  Processing  CSCI: 

a.  Perform  file  management 

b.  Control  Input/output  operations 

c.  Save  and  raoall  all  information  necessary  to  start  a  new  GIPSY 
session  from  the  departure  point  of  the  current  GIPSY  session 

d.  Convert  the  qualified  data  and  its  internal  matrix  version 

e.  Generate  a  metafile  in  standardized  format 

f.  Control  various  devices  such  as  terminals,  printers,  or  plotters  via 
device  drivers 

g.  Request  operating  system  servioes 

h.  Perform  specialize  processing  by  executing  ays tern- supplied  and  user 
subroutines 

i.  Allow  certain  globals  to  prevail  throughout  a  user  session 
(1)  Command  line  options 
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(2)  Module  transfer 

(3)  Classification  markings 

(4)  Report  titles  and  modification 

(5)  Clearing  specific  commands 

(6)  Size  of  tsxt 

(7)  Color  of  text 

j .  Color  processing 

k.  User  control  of  operating  environment  attributee 

l.  Identify  GIPSY's  collective  input  statements 

(1)  Process  Control  Statement  (PCS) 

(2)  Clear  PCS 

(3)  Save  PCS 

(4)  RETURN  statement 

m.  Identify  and  save  GIPSY' s  internal  data  structures 

(1)  FDT 

(2)  QDF 

(3)  QDT 

(4)  DAFC 

(3)  Graphic  Data  Set  (CDS) 

n.  Execute  user-supplied  subroutines 

o.  Execute  other  TSS  or  JDAC  commands. 

4.1.8  Programmer  Utilities.  The  Programmer  Utilities  CSCI  will  perform 
system  development  and  maintenance  functions.  The  following  functions  must  be 
performed  by  the  Programmer  Utilities  CSCI: 

a.  Provide  statistical  reports  about  MAGIC  usage 

b.  Generate  printed  listings  of  MACIC  source  code 
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c.  Sort  list  of  source  file  information  (l.e.,  sort  CLISx; 

d.  Identify  differences  between  two  MAGIC  source  code  files 

a.  Update  GIPSY  area/location  names 

f.  Update  GIPSY  terminal  definitions  and  capabilities 

g.  Update  MAGIC  user  help  and  error  messages 

h.  Update  GIPSY  World  Data  Base  II 

i.  Convert  the  file  that  contains  all  Information  necessary  to  start  a 
new  GIPSY  session  from  the  departure  point  of  the  current  GIPSY 
session  (l.e.,  the  DAFC)  from  the  Operational  Test  version  to  the 
Production  version  of  GIPSY  of  the  same  release. 

4.2  Computer  System  Functions 

This  paragraph  Identifies  and  describes  any  functions  (previously  listed  in 
paragraph  4.1)  that  are  allocated  to  external  systems  (the  Unix  operating 
system  on  the  workstation  and  the  various  host-based  system  services  such  as 
GCOS  8,  TSS,  Defender,  etc.).  Sines  all  interfacing  with  external  systems  is 
accomplished  through  the  Internal  Processing  CSCI,  only  functions  performed 
within  that  subsystem  are  valid  for  consideration  here: 

a.  Perform  file  management 

b.  Control  Input/output  operations 

c.  Control  various  devicss  such  as  terminals,  printers,  or  plotters  via 
device  drivers 

d.  Request  operating  system  services 

e.  Perform  specialize  processing  by  executing  system-supplied  and  user 
subroutines 

f.  User  control  of  operating  environment  attributes 

g.  Identifying  GIPSY'S  collective  input  statements:  clear  PCS,  save  PCS, 
and  the  RETURN  statement 

h.  Identify  and  save  GIPSY'S  internal  data  structures:  FDT. 

4.3  0ptm8rl.jnA,Miir„Infcirflstl9n 

MAGIC  will  execute  in  the  Unix  operating  system  environment  on  the  WWMCCS 
Workstation  platform  (assumed  to  be  a  Macintosh  llfx) .  In  addition  to 
execution  on  this  target  platform,  prototype  MAGIC  software  will  be  developed 
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for  execution  on  a  Sun  Scalable  Processor  Architecture  (SPARC)statlon.  Since 
MAGIC  executes  on  Unix-based  workstations,  no  operator  interaction  is  required 
for  system  operation. 

Two  separate  operational  states  will  be  supported  for  MAGIC'S  user- 
interaction:  assisted  and  unassisted.  Furthermore,  each  state  possesses  two 
operational  modes :  local  and  remote.  The  type  of  state  refers  to  whether  or 
not  the  user  will  be  utilizing  the  full  range  of  menus,  screens,  and  dialog 
boxes  that  MAGIC  can  provide.  Thu  unassisted  state  of  operation  provides 
basic  system  services  to  the  user  (system  menus,  help,  etc.)  but  provides  no 
assistance  in  the  utilization  of  the  various  COTS  packages.  The  type  of 
operational  mode  refers  to  whether  or  not  the  user  is  executing  MAGIC  in 
stand-alone  mods  (the  default)  or  as  a  remote  workstation  logged  into  an 
H6000/DPS8000  host  platform. 
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This  paragraph  Identifies  and  describes  the  characteristics  of  MAGIC  within 
the  overall  system. 

4.4.1  Hardware .  The  computer  equipment  required  to  perform  MAGIC'S  allocated 
functions  has  been  previously  discussed  in  paragraph  3.4  in  terms  of  the 
operational  support  to  be  provided.  Reference  should  be  made  to  that 
paragraph  for  further  details  concerning  MAGIC'S  hardware  requirements. 

4.4.2  Software .  By  nature,  MAGIC  is  a  general  purpose  information  handling 
system  that  combines  the  capabilities  of  operational  processing  and  database 
management  functions.  The  basic  software  configuration  has  besn  previously 
discussed  in  paragraph  3.4  and  reference  should  be  made  to  that  paragraph  for 
further  details  regarding  minimal  MAGIC  software  requirements.  Additional 
types  of  software  required  by  MAGIC  include; 

a.  AUS I -compliant  C  compiler  and  linker 

b.  Honeywell  General  Comprehensive  Operating  System  (GCOS)  8 

c.  Honeywell  Time  Sharing  System  (TSS) 

d.  Graphic  Information  Presentation  System  (GIPSY). 
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SECTION  5.  GOVERNMENT  AGENCIES 

The  development  and  support  for  MAGIC  rests  completely  with  the  Information 
Systems  Branch  (JNGC)  with  technical  aupport  provided  by  contractors  as 
needed.  However,  listed  below  are  a  large  number  of  user  agencies: 

a.  Aerospace  Defense  Command  (ADCOM) 

b.  Air  Training  Command  (ATC) 

c.  Air  University  (AU) 

d.  Air  Force  Combat  Operations  Center  (AFCOS) 

e.  Air  Force  Data  Services  Center  (AFDSC) 

f.  Air  Force  Data  Systems  Design  Center  (AFDSDC) 

g.  U.S.  Army  Command  and  Control  Support  Agency  (CCSA) 

h.  Commander-In-Chief,  U.S.  Army,  Europe  (CINCUSAREUR) 

i.  Atlantic  Command  Operations  Support  Faolllty 

J .  2199th  Computer  Service  Center 

k.  4602nd  CFUSS 

l.  U.S.  Army  War  College  (USAVC)  Operations  Group 

m.  Fleet  aerations  Command,  Europe  (FOCEUR) 

n.  I  S.  Army  Fovcaa  Command  (FORSCOM) 

o.  Alaskan  Air  Command  (AAC) 

p.  Air  Force  Systems  Command  (AFSC) 

q.  Headquarters,  U.S.  Air  Force  (HQ  USAF) 

r.  Air  Force  Communications  Command  (AFCC) 

s.  Air  Force  Manpower  and  Personnel  Center  (AFMPC) 

t.  Pacific  Air  Forces  (PACAF) 

u.  Strategic  Air  Command  (SAC) 

v.  U.S.  Southern  Command  (USSOUTHCOM) 
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w.  Tactical  Air  Command  (TAC) 

x.  U,S.  Europaan  Command  (USEUCOM) 

y.  Haadquartara ,  U.S.  Marina  Corpa  (HQ  USMC) 

z.  Military  Airlift  Command  (MAC) 

aa.  Atlantic  Command  (LANTCOM) 

ab.  Military  Saalift  Command  (MSC) 

ac.  Military  Traffio  Management  Command  (MTMC) 

ad.  Navy  Ragional  Data  Automation  Cantar  (NARDAC) 
aa.  Naval  Elaotronic  Syatama  Command 

af.  Joint  Chiafa  of  Staff  (JCS) 

(1)  Saoratary,  Joint  Chiafa  of  Staff  (SJCS) 

(2)  Manpower  and  Paraonnal  Diractorata  (J-l) 

(3)  Operations  Diractorata  (J*3) 

(A)  Logistics  Diractorata  (J-4) 

(5)  Command,  Control,  and  Communications  Syatama  Diractorata  (J-6) 

(6)  Operational  Plans  and  Interoperability  Diractorata  (J-7) 

(7)  Joint  Special  Operations  Agency  (JSOA) 

ag.  Office  of  the  Saoratary  of  Defansa/Diractor,  Program  Analysis  and 
Evaluation  (OSD/PA&E) 

ah.  Assistant  Secretary  of  Defense  for  Intarnational  Security  Policy 
(ASD/ISP) 

ai.  Director  for  Information  Resource  Management  (DIRM) 

aj.  Pacific  Fleet  (PACFLT) 

ak.  Puget  Sound  Naval  Shipyard 

al.  Command- in- Chief,  Pacific  (CINCPAC) 

am.  U.S.  Forces,  Japan 
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an.  U.S.  Forces,  Korea 


ao.  U.S.  Central  Command  (USCENTCOM) 

ap.  Commander-In-Chief,  U.S.  Readineie  Command  (USCINCRED) 

aq.  U.S.  Veaearn  Command  (WESTCOM) . 
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SECTION  6.  NOTES 


This  section  contains  information  of  general  interest  which  aids  in 
understanding  this  specification.  Specifically,  bibliography  references  to 
include  both  source  and  issue  data  are  provided  as  well  as  a  terms  and 
abbreviations  paragraph. 

6 . 1  Bibliography 

The  following  references  ware  used  in  the  preparation  of  this  document: 

a.  Department  of  Defense  (DOD),  Defense  System  Software  Development. 
Department  of  Defense  Standard  DOD-STD-2167A,  Washington,  D.C., 

29  February  1988 

b.  DOD,  Operational  Concent  Document.  Data  Item  Description  (DID) 
DI-MCCR-80023,  Washington,  D.C.,  4  June  1983 

c.  Joint  Data  Systems  Support  Center  (JDSSC),  Documentation  Standards 
and  Publications  Style  Manual.  Procedures  Manual  (PM)  1*90, 
Washington,  D.C.,  1  August  1990 

d.  JDSSC,  Functional.  Description  for  the  Graphic  Information 
Presentation  System  (0IPSY1.  <referanoe>,  Washington,  D.C., 

1  February  1988 

a.  JDSSC,  SIESYmitS  UiSM  Manus 1.  Computer  System  Manual  (CSM)  Users 
Manual  (UM)  303-87,  Washington,  D.C.,  6  April  1987;  Change  1,  31  May 
1988;  Change  2,  1  March  1989 

f.  JDSSC,  Graphic  Information  Preaantatlon  System  (GIPSY)  Users  Manual. 
Computer  System  Manual  (CSM)  Users  Manual  (UM)  239-83,  13  August 
1983;  Change  1,  30  April  1986;  Change  2,  3  March  1987;  Change  3,  31 
May  1988;  Change  4,  9  January  1989;  Change  5,  1  November  1989 

(•  JDSSC,  Software  Development  Plan  (SDPI  for  the  Meaning  and  Graphic 
Information  .CaPAkUltY.lhASIC) ,  SDP  2-90,  Washington,  D.C. , 

1  November  1990 

h.  JDSSC,  Software  Quality  Program  Plan  for  the  Mapping  and  Graphic 
Information  fiiaghiJJJaLillAfilfil  (Draft),  <referenoe>,  Washington, 

D.C. ,  23  July  1990 

i.  JDSSC,  Software-Standards  and  Procedures  Manual  for  the  JNGQ  Graphics 
Program .  Technical  Memorandum  (TM)  403-90,  Washington,  D.C., 

1  December  1990 

j.  JDSSC,  System  Daalen  Document  for  the  Modernised  QIPSYmate  System. 
System  Planning  Manual  (SPM) -System  Specification  (SS)  161-88, 
Washington,  D.C.,  14  July  1988. 
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Tha  following  terms,  abbreviations,  and  acronyms  specific  to  this  document  are 
lleted  below, 


AAC . Alaakan  Air  Command 

ADCOM  .  Aerospace  Defense  Command 

ADP  .  Automated  Data  Processing 

AFCC  .  Air  Force  Communications  Command 

AFCOS  .  Air  Force  Combat  Operations  Canter 

AFDSC . Air  Force  Data  Services  Center 

AFDSDC  .  Air  Force  Data  Systems  Design  Center 

AFMPC  .  Air  Force  Manpower  and  Personnel  Center 

AFSC  .  Air  Force  Systems  Command 

ANSI  .  American  National  Standards  Institute 

ASCII  .  American  Standard  Coda  for  Information  Interohange 

ASD/ISP  .  Assistant  Secretary  of  Defense  for  International  Security 

Policy 

ATC . Air  Training  Command 

AT&T  . .  American  Telephone  and  Telegraph 

AU . Air  University 

A/UX  .  Apple/Unix  operating  system 

CCSA  .  U.S.  Army  Command  and  Control  Support  Agency 

CINCPAC  .  Commander* in* Chief,  Pacific 

CINCUSAREUR  ••••  Command- in- Chief ,  U.S.  Army,  Europe 

COTS  .  Commercial  Off-The-Shelf 

CSCI  .  Computer  Software  Configuration  Item 

CSM  .  Computer  System  Manual 

DAFC  .  Directive  Aotlon  File  Control;  s  file  structure  used  by  CIPSY 

DI  . Data  Item 

DID . Data  Item  Description 

DIRM  .  Director  for  Information  Resource  Management 

DOD  .  Department  of  Defense 

DOD-STD  .  Department  of  Defense  Standerd 

DMS  .  DsLorme  Mapping  System 

DPS8000  . Honeywell's  Distributed  Processing  System  if  SOOO 

FDT  .  File  Descriptor  Table;  a  file  atructure  used  by  CIPSY 

FOCEUR  .  Fleet  Operations  Command,  Europe 

FORSCOM  .  U.S.  Army  Forces  Command 

OCOS  8  .  Honeywell's  Csneral  Comprehensive  Operating  System  8 

CDS . Craphlc  Data  Sat;  a  fils  structure  used  by  OIPSY 

Gigabyte  .  1,000  megabytes;  1,024,000,000  bytes  of  data 

GIPSY  .  Graphic  Information  Presentation  System 

GIPSYmate  .  A  PC-based  system  developed  to  permit  OIPSY  access  to  users 

of  the  WIS  Early  Products  Workstation  (an  IBM  3270  PC/XT) 

CUI  .  Graphical  User  Interface 

HIS  .  Honeywell  Information  Systems 

HQ  USAF . Headquarters,  U.S.  Air  Force 

HQ  USMC  .  Headquarters,  U.S.  Marine  Corps 
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H6000 


Centric  tern  for  the  family  of  Honeywell  mainframe  computer© 
that  Include  the  HIS  6080- • the  VWMCCS  host  platform 


IBM  .  International  Business  Machines,  Incorporated 

I/O  .  Input/Output 

JCS . Joint  Chiefs  of  Staff 

JDSSC  .  Joint  Data  Systems  Support  Center 

JN . NMCS  ADP  Dlreetorate 

JNG  .  Oeneral  Applications  Division 

JNOO  .  Information  Systems  Branoh 

•JSOA . Joint  Speolal  Operations  Agency 

JTSA-P  .  Administrative  Control  Branoh;  Pentagon  Teohnloal  Resource 

Canter,  Room  MF612A 

J*1  .  Dlreotor  for  Manpower  and  Personnel  for  the  JCS 

J-3  .  Dlreotor  for  Operations  for  the  JCS 

J *4 . Director  for  Loglatloe  for  the  JCS 

J-6  .  Director  for  Command,  control,  and  Communications  Systems  for 

the  JCS 

J-7  .  Director  for  Operational  Plans  and  Interoperability  for  the 

JCS 

LANTCOM  .  Atlantic  Command 

MAC  .  Military  Airlift  Command 

MA01C  .  Mapping  and  Craphlo  Information  Capability 

Mb  .  Megabyte;  1,024,000  bytea  of  data 

MCCR  .  Mission-Critical  Computer  Resources 

MIT  .  Massachusetts  Institute  of  Technology 

Motif  .  User  interface  toolkit  built  on  the  X  Window  System 

MSC  .  Military  Sealift  Command 

MTMC  .  Military  Trafflo  Management  Command 

NARDAC  .  Navy  Regional  Data  Automation  Center 

NMCS  .  National  Military  Command  System 

0CD  .  Operational  Concept  Document  as  defined  In  DOD- STD- 2167  and 

Its  aaeooiated  DID  #  DI-MCCR-80023 

OSD  .  Office  of  the  Secretary  of  Defense 

OSF  .  Open  Software  Foundation 

PACAF .  Pacific  Air  Forces 

PACFLT  .  Pacific  Fleet 

PA&E . Director,  Program  Analysis  and  Evaluation  for  the  OSD 

PC  .  Personal  Computer 

PCS  .  Process  Control  Statement;  a  file  structure  used  by  CIPSY 

PM  .  Procedures  Manual 

PoatSorlpt  .  A  general  purpose,  page-oriented  programming  language  with 

powerful  built-in  graphic  primitives  that  is  marketed  by 
Adobe  Systems  Incorporated 

PowerPoint  .  A  program  for  planning,  composing,  and  creating  desktop  slide 

presentations  marketed  by  Microsoft  Corporation 

QDF  .  Qualified  Data  File;  a  file  structure  used  by  GIPSY 

QDT . Qualified  Data  Table;  a  file  structure  used  by  GIPSY 

RAM  .  Random  Access  Memory 

RDBMS  .  Relational  Database  Management  System 
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SAC  .  Strategic  Air  Command 

SecureWare  - .  The  package  provided  with  the  WWMCCS  Workstation  to  fatisfy 

ADP  security  requirements 

SDP  .  Software  Development  Plan  ea  defined  in  DOD-STD'2167A  and  its 

aesocieted  DID  it  DI-MCCR-80030A 
SJCS  .  Secretary,  Joint  Chiefs  of  Staff 

SPARC  .  Scalable  Processor  Archltacture  marketed  by  Sun  Microsystems 

Incorporated 

SPM  .  System  Planning  Manual 

SS  .  System  Spacification 

TAC . Tactical  Air  Command 

TM . Technical  Memorandum  aa  specified  in  JDSSC  PM  1*90 

TSS . Honeywell’s  Time  Sharing  Syatam  on  the  H6000 

UM  .  Users  Manual 

Unix  .  A  multi 'tasking  operating  system  from  AT&T  that  executaa  on  a 

vide  variety  of  computer  platforms  from  mloro  to  mainframe 

USAWC . U.S.  Army  War  College 

USCENTCOM  .  U.S.  Central  Command 

USCXNCRBD  .  Command* in 'Chief,  U.S.  Readiness  Command 

USEUCOM  .  U.S.  European  Command 

U8SOUTHCOM  .  U.S.  Southern  Command 

VE8TCOM  .  U.S.  Western  Command 

Wings  .  A  spreadsheet  program  which  has  its  own  programming  language 

(HyparScrlpt) ,  drawing,  and  ohart*maklng  tools 

VIS  .  WWMCCS  Information  Systems 

WWMCCS  .  Worldwide  Military  Command  and  Control  Syatam 

WWS  .  WWMCCS  Workstation 

X  Windows  .  A  device -independent  and  network' transparent  windowing 

protocol  for  graphics  workstations  developed  at  MIT  and 
copyrighted  in  1984 

X11R3  .  Acronym  designating  X  Windows  version  11.  release  3 
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